<!doctype html>
<html>
<head>
<meta charset="utf-8"/>
<title>selector &lsaquo; KISSY Docs</title>
<link rel="stylesheet" href="../assets/base-min.css" />
<link rel="stylesheet" href="../assets/docs.css" />
</head>
<body class="w866">
<div id="header">
    <a class="logo" href="../index.html"><img src="../assets/logo.png" alt="KISSY" width="138" height="74" /></a>
    <p class="rel-nav">
        <a href="http://github.com/kissyteam/kissy/blob/master/src/dom/selector.js"><code>selector.js</code></a>
    </p>
</div>
<div id="content" class="layout grid-s232m0">
    <div class="col-main">
        <div class="main-wrap">

            <div class="section summary">
                <p>CSS Selector 可以让我们用非常精简的代码快速获取所需的 DOM 元素，KISSY 为你提供了一个非常高效快速的选择器。</p>
            </div>

            <div class="section">
                <h3 id="methods">Methods</h3>

                <div class="member method">
                    <h4>
                        <a name="method_query">query</a>
                        <code>Array&lt;HTMLElement&gt; <em>query</em> ( selector, context )</code>
                    </h4>
                    <div class="detail">
                        <p>获取符合选择器的所有元素。</p>
                        <p>该方法的返回值始终是数组。</p>
                    </div>
                </div>

                <div class="member method">
                    <h4>
                        <a name="method_get">get</a>
                        <code>HTMLElement <em>get</em> ( selector, context )</code>
                    </h4>
                    <div class="detail">
                        <p>获取符合选择器的第一个元素。</p>
                        <p>不存在时返回 null.</p>
                    </div>
                </div>

                <div class="member method">
                    <h4>
                        <a name="method_filter">filter</a>
                        <code>Array&lt;HTMLElement&gt; <em>filter</em> ( selector, filter )</code>
                    </h4>
                    <div class="detail">
                        <p>根据选择器获取满足过滤条件的所有元素。</p>
                        <dl class="parameters">
                            <dt>Parameters:</dt>
                            <dd>
                                <code class="param-name">filter</code>
                                <code class="param-type">&lt;String|Function&gt;</code>
                                过滤条件，可以是 selector 或 function.
                            </dd>
                        </dl>
                    </div>
                </div>

                <div class="member method">
                    <h4>
                        <a name="method_test">test</a>
                        <code>Boolean <em>test</em> ( selector, filter )</code>
                    </h4>
                    <div class="detail">
                        <p>判断根据选择器获取的所有元素是否都符合过滤条件。</p>
                    </div>
                </div>

            </div>

            <div class="section">
                <h3>Examples</h3>
                <p>请直接查看测试页面：<a href="http://kissyteam.github.com/kissy/src/dom/test-selector.html"><code>test-selector.html</code></a></p>

                <p class="tips">注意：默认情况下，KISSY 选择器仅支持 <code>#id tag.class</code> 常用形式：</p>
<pre class="example-code"><code>
// Ref: http://ejohn.org/blog/selectors-that-people-actually-use/
// 考虑 2/8 原则，仅支持以下选择器：
// #id
// tag
// .cls
// #id tag
// #id .cls
// tag.cls
// #id tag.cls
// 注 1：REG_QUERY 还会匹配 #id.cls
// 注 2：tag 可以为 * 字符
// 注 3：支持 , 号分组
// 返回值为数组
// 选择器不支持时，抛出异常
</code></pre>
                <p>当加载了 sizzle 模块时，KISSY 支持 jQuery 支持的所有 CSS 选择器，具体请参考：<a href="http://wiki.github.com/jeresig/sizzle/">Sizzle Documents</a></p>
            </div>
        </div>
    </div>
    <div class="col-sub">
        <div class="sub-wrap">
            <div class="loc">
                <a href="../index.html">home</a> &rsaquo;
                <a href="index.html">dom</a> &rsaquo;
                selector :
            </div>
            <div class="toc">
                <h3>Methods</h3>
                <ul>
                    <li><a href="#method_query">query</a></li>
                    <li><a href="#method_get">get</a></li>
                    <li><a href="#method_filter">filter</a></li>
                    <li><a href="#method_test">test</a></li>
                </ul>
            </div>
        </div>
    </div>
</div>
<div id="footer">
    <p class="copyright">&copy; 2009 - 2029 KISSY UI LIBRARY</p>
</div>
</body>
</html>
